• Pass elementToBeCreated as a third parameter to shouldForwardProp so that the user-specified function can decide whether to pass through props based on whether the created element will be a tag or another component. (see #3436)

• Fix React Native components accepts function as style prop. (see #3389)

fix an issue with an unguarded window accessor in a SSR path (see #3446)

• For React Native based components, pass testID down to the native component if specified for an easier time testing. (see #3365)

• Enable users of the babel macro to customize the styled-components import with importModuleName (see #3422)

• [fix] COMPLEX_SELECTOR_PREFIX.includes wasn't transpiled (see #3397)

Tweak server-side build settings to resolve an issue with jest-dom not being able to pick up generated styles (see #3308) thanks @ Lazyuki

• Make sure StyleSheetManager renders all styles in iframe / child windows (see #3159) thanks @ eramdam!

• Rework how components self-reference in extension scenarios (see #3236); should fix a bunch of subtle bugs around patterns like & + &

• Fix keyframes not receiving a modified stylis instance when using something like stylis-plugin-rtl (see #3239)

• Big performance gain for components using style objects (see #3239)

• We no longer emit dynamic classNames for empty rulesets, so some className churn may occur in snapshots

• Preallocate global style placement to ensure cGS is consistently inserted at the top of the stylesheet; note that this is done in runtime order so, if you have multiple cGS that have overlapping styles, ensure they're defined in code in the sequence you would want them injected (see #3239)

• Add "engines" to package.json (currently set to Node 10, the oldest supported LTS distribution) (see #3201) thanks @ MichaelDeBoey!

Finally, special thanks to @ willheslam for testing and some last minute fixes on this release!

We are planning to release 5.2 on September 2/3, please help us test!

yarn add styled-components@test

• Preallocate global style placement to ensure cGS is consistently inserted at the top of the stylesheet; note that this is done in runtime order so, if you have multiple cGS that have overlapping styles, ensure they're defined in code in the sequence you would want them injected (see #3239)

  NOTE: This is a behavioral change and might require adjustment in your codebase if you have many createGlobalStyle components in use. We do not think it will affect the majority of projects other than fix existing bugs.

• createGlobalStyle is now React.StrictMode compliant

• Make sure StyleSheetManager renders all styles in iframe / child windows (see #3159) thanks @ eramdam!

• Rework how components self-reference in extension scenarios (see #3236); should fix a bunch of subtle bugs around patterns like & + &

• Fix keyframes not receiving a modified stylis instance when using something like stylis-plugin-rtl (see #3239)

• Big performance gain for components using style objects (see #3239)

• We no longer emit dynamic classNames for empty rulesets, so some className churn may occur in snapshots

• Add "engines" to package.json (currently set to Node 10, the oldest supported LTS distribution) (see #3201) thanks @ MichaelDeBoey!

New Functionality

• Implement shouldForwardProp API for native and primitive platforms, which was previously missing in [v5.1.0] (see #3093)
  This has been released under a patch bump instead of a minor, since it's only been missing from Native-support.

Bugfixes

• Added useTheme hook to named exports for react-primitives entrypoint (see #2982) thanks @ jladuval!
• Escape every CSS ident character necessary when converting component display names to class names (see #3102) thanks @ kripod!